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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part 3 of a muhi-part deUverable covering the 3'^'' Generation Partnership Project; Technical 
Specification Group Services and System Aspects, Telecommunication management; Fault management as identified 
below: 

Part 1: "3G Fault management requirements"; 

Part 2: "Alarm Integration Reference Point: Information Service"; 

Part 3: "Alarm Integration Reference Point: CORBA Solution Set"; 

Part 4: "Alarm Integration Reference Point: CMIP Solution Set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document specifies the CORBA Solution Set (SS) for the IRP whose semantics is specified in Alarm IRP: 
Information Service (IS) (TS 32.111-2 [6]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. Clause 

5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. Clause 

6 describes the notification interface containing the push method. Annex A contains the IDL specification. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

http://www.omg.org/technologv/documents/ 

[2] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification), http://www.omg.org/technologv/documents/ 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] 3GPP TS 32.302: "Telecommunication Management; Configuration Management; Notification 

Integration Reference Point; Information Service version 1". 

[5] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point; CORBA solution set version 1:1". 

[6] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point: Information Service". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.111-2 [6] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 
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NE 
OMG 
TMN 
UML 



Network Element 
Object Management Group 
Telecommunications Management Network 
Unified Model Language 



3.3 IRP document version number string 

The IRP document version number (sometimes called "IRP version" or "version number") string is used to identify the 
present document. The string is derived using the following rule. 

Take the 3GPP document number on the front page of the present document, such as "3GPP TS 32.106-3 V3.2.0 (2000- 
12)". Discard the leading "3GPP TS". Discard all characters after and including the last period. Eliminate leading and 
trailing spaces. Reduce multiple consecutive spaces with one space. Express the resultant in a string. Capitalised the 
string. For example, if the 3GPP document version number is "3GPP TS 32.106-3 V3.2.0 (2000-12)", then the IRP 
document version number shall be "32.106 V3.2". 

This string is returned in getAlarmlRPVersion method and is carried in the first field of the notification header of 
all notifications related to alarm IRP. 



4 Architectural Features 

The overall architectural feature of Alarm IRP is specified in TS 32.111-2 [6]. This clause specifies features that are 
specific to the CORBA SS. 



4.1 



Notification Services 



In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotif ications notifications as specified in TS 32.111-2 [6]. 

4.2 Push and Pull Style 

OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 

4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 
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4.4 



Filter 



IRPAgent shall optionally support alarm filtering based on IRPManager's supplied alarm filter constraints (e.g. as 
parameter in subscribe() of TS 32.302 [4]. Alarm filtering can be applied in the following cases: 

It is applicable to alarms emitted by IRPAgent via AlarmlRPNotif ications. IRPManager supplies alarm 
filter constraint via the subs cribe method. This filter is effective during the period of subscription. 

It is applicable to alarms returned by IRPAgent via the out parameter of get_alarm_list method. 
IRPManager supplies alarm filter constraint via the get_alarm_list method. This filter is effective only for 
this method invocation. 

It is applicable to the calculation of alarm counts returned by IRPAgent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count 
method. This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference OMG Notification Service [1]. The name of the 
grammar is called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in OMG Notification Service 
[1]. This SS shall use this grammar only. 



5 Mapping 

5.1 Operation and Notification mapping 

Alarm IRP: IS TS 32. 1 1 1 -2 [6] defines semantics of operation and notification visible across the Alarm IRP. Table 1 
indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table 1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification TS 32.111-2 [13] 


SS Method 


Qualifier 


acknowledgeAlarms 


acknowledge alarms 


M 


unacknowledgeAlarms 


unacknowledge alarms 


O 


getAlarmList 


get alarm list 


M 


getlRPVersion 


get alarm IRP versions 


M 


getAlarmCount 


get alarm count 





setComment 


comment alarms 





getOperationProfile 


get alarm IRP operations profile 





getNotificationProfile 


get alarm IRP notification profile 





notifyNewAlarm 


push_structured_event 

Note that OIVIG Notification Service OIVIG Notification 

Service [1] defines this method. 

See clause 6.1 


M 


notifyClearedAlarm 


push_structured_event 
See clause 6.1 


M 


notifyChangedAlarm 


push_structured_event 
See clause 6.1 


M 


notifyAckStateChanged 


push_structured_event 
See clause 6.1 


M 


notifyAlarmListRebuilt 


push_structured_event 
See clause 6.1 


M 


notifyComments 


push_structured_event 
See clause 6.1 
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5.2 Operation parameter mapping 

Reference TS 32.111-2 [6] defines semantics of parameters carried in operations across the Alarm IRP. The following 
set of tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS acknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS {Method parameter 


Qualifier 


alarmlnformationAndSeverity 
ReferenceList 


AlarmlRPConstDefs::AlarmlnformationldAndSevSeq 

alarm_information_id_and_sev_list 

Note: perceivedSeverity is optional 

{ alarm Id - Mandatory; 

perceivedSeverity - Optional 

} 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


string ack system id 





bad Alarm Information ReferenceList 


AlarmlRPConstDefs::BadAcknowledgeAlarmlnfoSeq 
bad ack alarm info list 


M 


status 


IVIanagedGenericlRPConstDefs::Signal 

Exceptions: 

AcknowledgeAlarms, 

IVIanagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 3: Mapping from IS unacknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS IMethod parameter 


Qualifier 


alarm InformationReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq 
alarm information id list 


M 


ackUserld 


string ack user id 


M 


ackSystemId 


string ack system id 





badAlarm Information ReferenceList 


AlarmlRPConstDefs:: BadAlarmlnformationldSeq 
bad alarm information id list 


M 


status 


IVIanagedGenericlRPConstDefs::Signal 

Exceptions: 

UnacknowledgeAlarms, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



Table 4: Mapping from IS getAlarmLlst parameters to SS equivalents 



IS Operation parameter 


SS IMethod parameter 


Qualifier 


alarmAckState, filter 


string filter 





alarmlnformation List 


Return value of type 

Alarm! RPConstDefs::AlarmlnformationSeq 


M 


status 


Exceptions: 

GetAlarmLlst, 

ManagedGenericlRPSystem::ParameterNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 5: Mapping from IS getAlarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 





criticalCount, majorCount, minorCount, 

warningCount, 

indeterminateCount,clearedCount 


long critical_count, long major_count, long minor_count, long 
warning_count, long indeterminate_count, long cleared_count 


M 


status 


Exceptions: 

GetAlarmCount, 

IVIanagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



Table 6: lUlapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type 
IVIanagedGenericlRPConstDefsiiVersionNumberSet 


M 


status 


Exceptions: 
GetAlarmlRPVersions 


M 



Table 7: lUlapping from IS setcomment parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


Alarmlnformation ReferenceList 


AlarmlRPConstDefs::AlarmlnformationldSeq 
alarm information id list 


M 


commentUserld 


string comment user id 


M 


commentSystemId 


string comment system id 





commentText 


string comment text 


M 


badAlarmlnformationReferenceList 


AlarmlRPConstDefs::BadAlarmlnformationldSeq 
bad alarm information id list 


M 


status 


IVIanagedGenericlRPConstDefsiiSignal 

Exceptions: 

GommentAlarms, 

IVIanagedGenericlRPSystemiiOperationNotSupported, 

ManagedGenericlRPSystem::ParameterNotSupported 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 8: lUlapping from IS getOperationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPConstDefs::VersionNumber 
alarm irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type IVianagedGenerlclRPGonstDefs::MethodList 


M 


status 


Exceptions: 

GetAlarmlRPOperationsProfile, 

IVIanagedGenericlRPSystemiiOperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 9: lUlapping from IS getNotif icationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


irpVersion 


ManagedGenericlRPGonstDefs::VersionNumber 
alarm irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type IVIanagedGenericlRPGonstDefs::IVIethodList 


M 


status 


Exceptions: 

GetAlarmlRPNotificationProfile, 

l\/lanagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 
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5.3 Notification parameter mapping 

Reference TS 32.1 1 1-2 [6] defines semantics of parameters carried in notifications. The following tables indicate the 
mapping of these parameters to their OMG CORBA Structured Event (defined in OMG Notification Service [1]) 
equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [1], is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
Alarm IRP: IS [6] defined notification parameters. 

Table 10: Mapping for notifyNewAiarm 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 




It carries the IRP document version number string. See sub- 
clause 3.3. 

It indicates the syntax and semantics of the Structured Event as 
defined by this specification. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_NEW_ALARM of interface 
NotificationType of module AlarmlRPConstDefs. 


alarmType 


event_name 


M 


It identifies one of the following: 
communications alarm, 
processing error alarm, 
environmental alarm, 
quality of service alarm and 
equipment alarm. 

It is a string defined by interface AlarmType of module 
AlarmlRPConstDefs. 


There is no 
corresponding SS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 

filterable_ 

bodyjields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. 


notificationid 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. 


eventTime 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a IRPTime of module 
ManagedGenericlRPConstDefs. 


systemDN 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. 


probableCause 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the PROBABLE_CAUSE of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface ProbableCause of 
module AlarmlRPConstDefs. 
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IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


perceivedSeverity 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the PERCEIVED_SEVERITY of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface PerceivedSeverity 
of module AlarmlRPConstDefs. 


specificProblem 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the SPECIFIC_PROBLEIVI of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


correlatedNotifications 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the CORRELATED_NOTIFICATIONS of 
interface AttributeNameValue. 

Value of NV pair is a CorrelatedNotificationSetType of module 
AlarmlRPConstDefs. 


backedUpStatus 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the BACKED_UP_STATUS of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a boolean BackedUpStatusType of module 
AlarmlRPConstDefs. 


backUpObject 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the BACK_UP_OBJECT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string carrying of DN of the back-up object. 
See 3G TS 32.300 [3] for the DN string representation. 


trendlndication 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the TRENDJNDICATION of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an enum TrendlndicationType of module 
AlarmlRPConstDefs. 


thresholdlnfo 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the THRESHOLDJNFO of interface 
ParameterNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a ThresholdlnfoType of module 
AlarmlRPConstDefs. 


stateChangeDefinition 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the STATE_CHANGE_DEFINITION of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an AttributeChangeSetType of module 
AlarmlRPConstDefs. 


monitoredAttributes 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the MONITORED_ATTRIBUTES of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is an AttributeSetType of module 
AlarmlRPConstDefs. 


proposedRepairActions 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the PROPOSED_REPAIR_ACTIONS of 
interface AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


additionalText 


One NV pair of 

filterable_ 

bodyjields 





Name of NV pair is the ADDITIONAL_TEXT of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


additionallnformation 


One or more NV 
pairs of 
filterable_ 
body fields 





Name and value of all NV pairs are vendor-specific. 


alarmld 


One NV pair of 

filterable_ 

bodyjields 


M 


Name of NV pair is the ALARIVI_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the 
default semantics is that alarmld is a concatenation of 
managedObjectlnstance, eventType, probableCause and 
specificProblem, if present, of this Structured Event. Since 
probableCause is encoded as a short, it shall be converted into 
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IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 








string before concatenation. Tlie resultant string shall not contain 
spaces. 


There is no 
corresponding IS 
attribute. 


remaining_ body 







Table 11: Mapping for notifyAckStateChanged 



IS Parameters 


OMG CORBA Structured 
Event attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_ACK_STATE_CHANGED of 
interface NotificationType of module Alarm IRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


notification Id 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


perceived Severity 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of filterable_ 
body fields 


M 


See that of notifyNewAlarm. 


ackTIme 


One NV pair of filterable_ 
bodyjields 


M 


Name of NV pair is the ACK_TIME of interface 
AttributeNameValue of module Alarm IRPConstDefs. 

Value of NV pair is a IRPTime of module 
IVlanagedGenericI RPGonstDefs. 


ackUserld 


One NV pair of filterable_ 
bodyjields 


M 


Name of NV pair is the ACK_USERJD of interface 
AttributeNameValue of module Alarm IRPConstDefs. 

Value of NV pair is a string. 


ackSystemId 


One NV pair of filterable_ 
bodyjields 





Name of NV pair is the ACK_SYSTEM_ID of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


ackState 


One NV pair of 
filterable_bodyJields 


M 


Name of NV pair is the ACK_STATE of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a short defined by interface AckState of 
module AlarmlRPConstDefs. 


There is no 
corresponding IS 
attribute. 


remaining_ body 
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Table 12: Mapping for notifyClearedAlarm 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


Ttiere is no corresponding 
IS attribute. 


domain_name 




See that of notify NewAlarm. 


notificationlype 


type_name 


M 


This is the NOTIFY_FM_CLEARED_ALARM of interface 
NotificationType of module Alarm IRPConstDefs. 


alarmlype 


event name 


M 


See that of notifyNewAlarm. 


Ttiere is no corresponding 
IS attribute. 


variable Header 






objectClass, objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notification Id 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceivedSeverity 


One NV pair of 
filterable_ body fields 


M 


See that of notifyNewAlarm. 


correlatedNotifications 


-- 


-- 


See Note. 


alarmld 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


Tliere is no corresponding 
IS attribute. 


remaining_ body 






NOTE: In the CORBA Solution Set the correlatedNotifications is not used. In the CORBA Solution Set, one 
notifyClearedAlarm notification can only clear a single alarmlnformation. 



Table 13: Mapping for notifyAlarmListRebuilt 



IS Parameters 


OIVIG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notifyNewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_ALARM_LIST_REBUILT of interface 
NotificationType of module AlarmlRPConstDefs. 


There is no 
corresponding IS 
attribute. 


event_name 


M 


Carry an empty string. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notification Id 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 





See that of notifyNewAlarm. 


reason 


One NV pair of 
filterable_ bodyjields 


M 


Name of NV pair is the REASON of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a string. 


There is no 
corresponding IS 
attribute. 


remaining_ body 







£75/ 



3GPP TS 32.111-3 version 4.6.0 Release 4 



14 



ETSI TS 132 111-3 V4.6.0 (2003-03) 



Table 14: Mapping for notifyChangedAlarm 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notify NewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_CHANGED_ALARM of interface 
NotificationType of module Alarm IRPConstDefs. 


alarmType 


event name 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


notification Id 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceived Severity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


There is no 
corresponding IS 
attribute. 


remaining_ body 
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Table 15: Mapping for notifyComments 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 




See that of notify NewAlarm. 


notificationType 


type_name 


M 


This is the NOTIFY_FM_COMMENT_ADDED of interface 
NotificationType of module AlarmlRPConstDefs. 


alarmType 


event name 


M 


See that of notify NewAlarm. 


There is no 
corresponding IS 
attribute. 


variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable body fields 


M 


See that of notify NewAlarm. 


notification Id 


One NV pair of 
filterable body fields 


M 


See that of notify NewAlarm. 


eventTime 


One NV pair of 
filterable body fields 


M 


See that of notify NewAlarm. 


systemDN 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


probableCause 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


perceived Severity 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


alarmld 


One NV pair of 
filterable body fields 


M 


See that of notifyNewAlarm. 


comments 


One NV pair of 
filterable_ bodyjields 


M 


Name of NV pair is the COMMENTS of interface 
AttributeNameValue of module AlarmlRPConstDefs. 

Value of NV pair is a CommentSet of module 
AlarmlRPConstDefs. 


There is no 
corresponding IS 
attribute. 


remaining_ body 
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6 AlarmlRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNotifications. All the 
notifications in this interface are implemented using this push_structured_event method. 

6.1 Method push (M) 

module CosNotifyComm ( 

Interface SequencePushConsumer : Notif yPublish ( 
void push_structured_events ( 

in CosNotif ication ; ; EventBatch notifications) 
raises ( CosEventComm; ; Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name "AlarmlRPConstDefs.idI") 

#ifndef AlarmlRPConstDef s_idl 
#define AlarmlRPConstDef s_idl 

#include "CosNotif ication. idl" 

#include "ManagedGenericIRPConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AlarmlRPConstDef s 

This module contains commonly used definitions for Alarm IRP 

*/ 

module AlarmlRPConstDef s 

{ 

/* 

This block identifies the alarm types specified for this IRP version. 

These types carry the same semantics as the TMN ITU-T defined event 

types of the same name. 

Their encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

alarm types for their use. They shall define their encodings 

as well. Values defined here are unique among themselves. 

*/ 

interface AlarmType 

{ 

const string C0I^1MUNICATI0NS_ALARM = "xl"; 

const string PROCESSING_ERROR_ALARM = "x2"; 

const string ENVIRONMENTAL_ALARM = "x3"; 

const string QUALITY_OF_SERVICE_ALARM = "x4"; 

const string EQUIPMENT_ALARM = "x5"; 

}; 

/* 

This block identifies the notification types defined by this 

Alarm IRP version. 

*/ 

interface Notif icationType 

{ 

const string NOTIFY_FM_NEW_ALARM = "xl"; 

const string NOTIFY_FM_CHANGED_ALARM = "x2"; 

const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 

const string NOTIFY_FM_COMMENT_ADDED = "x4"; 

const string NOTIFY_FM_CLEARED_ALARM = "x5"; 

const string NOTIFY_FM_ALARM_LIST_REBUILT = "x6"; 

}; 

/* 

This block identifies the levels of severity. 

*/ 

interface PerceivedSeverity 

{ 

const short INDETERMINATE = 1; 

const short CRITICAL = 2; 

const short MAJOR = 3; 

const short MINOR = 4; 

const short WARNING = 5; 

const short CLEARED = 6; 

}; 

/* 

This block identifies the probable cause of a reported alarm. 

*/ 

interface ProbableCause 
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= 56; 


= 57; 


59; 


60; 


61; 


= 62; 



INDETERMINATE = 0; 
ALARM_INDICATION_SIGNAL = 1; 
CALL_SETUP_FAILURE = 2; 
DEGRADED_SIGNAL_M3100 = 3; 
FAR_END_RECEIVER_FAILURE = 4; 
FRAMING_ERROR_M3100 = 5; 
LOSS_OF_FRAME = 6; 
LOSS_OF_POINTER = 7; 
LOSS_OF_SIGNAL = 8; 
PAYLOAD_TYPE_MISMATCH = 9; 
TRANSMISSION_ERROR = 10; 
REMOTE_ALARM_INTERFACE = 11; 
EXCESSIVE_BIT_ERROR_RATE = 12; 
PATH_TRACE_MISMATCH = 13; 
UNAVAILABLE = 14; 
SIGNAL_LABEL_MISMATCH = 15; 
LOSS_OF_MULTI_FRAME = 16; 
COMMUNICATIONS_RECEIVE_FAILURE = 17; 
C0I^1MUNICATI0NS_TRANSMIT_FAILURE = 18; 
MODULATION_FAILURE = 19; 
DEMODULATION_FAILURE = 20; 
BACK_PLANE_FAILURE = 51; 
DATA_SET_PROBLEM = 52; 

EQUIPMENT_IDENTIFIER_DUPLICATION = 53; 
EXTERNAL_DEVICE_PROBLEM = 54; 
LINE_CARD_PROBLEM = 55; 
MULTIPLEXER_PROBLEM_M3100 
NE_IDENTIFIER_DUPLICATION 
POWER_PROBLEM_M3100 = 58; 
PROCESSOR_PROBLEM_M3100 = 
PROTECTION_PATH_FAILURE = 
RECEIVER_FAILURE_M3100 = 
REPLACEABLE_UNIT_MISSING 
REPLACEABLE_UNIT_TYPE_MISMATCH = 63; 
SYNCHRONISATION_SOURCE_MISMATCH = 64; 
TERMINAL_PROBLEM = 65; 
TIMING_PROBLEM_M3100 = 66; 
TRANSMITTER_FAILURE_M3100 = 67; 
TRUNK_CARD_PROBLEM = 68; 
REPLACEABLE_UNIT_PROBLEM = 69; 
REAL_TIME_CLOCK_FAILURE = 70; 
PROTECTION_MECHANISM_FAILURE = 81; 
PROTECTING_RESOURCE_FAILURE = 82; 
AIR_COMPRESSOR_FAILURE = 101; 
AIR_CONDITIONING_FAILURE = 102; 
AIR_DRYER_FAILURE = 103; 
BATTERY_DISCHARGING = 104; 
BATTERY_FAILURE = 105; 
C0I^1MERICAL_P0WER_FAILURE = 106; 
COOLING_FAN_FAILURE = 107; 
ENGINE_FAILURE = 108; 
FIRE_DETECTOR_FAILURE = 109; 
FUSE_FAILURE = 110; 
GENERATOR_FAILURE = 111; 
LOW_BATTERY_THRESHOLD = 112; 
PUMP_FAILURE_M3100 = 113; 
RECTIFIER_FAILURE = 114; 
RECTIFIER_HIGH_VOLTAGE = 115; 
RECTIFIER_LOW_F_VOLTAGE = 116; 
VENTILATION_SYSTEM_FAILURE = 117; 
ENCLOSURE_DOOR_OPEN_M3100 = 118; 
EXPLOSIVE_GAS = 119; 
FIRE = 120; 
FLOOD = 121; 
HIGH_HUMIDITY = 122; 
HIGH_TEMPERATURE = 123; 
HIGH_WIND = 124; 
ICE_BUILD_UP = 125; 
INTRUSION_DETECTION = 12 6; 
LOW_FUEL = 127; 
LOW_HUMIDITY = 128; 
LOW_CABLE_PRESSURE = 12 9; 
LOW_TEMPERATURE = 130; 
LOW_WATER = 131; 
SMOKE = 132; 
TOXIC_GAS = 133; 
EXTERNAL_POINT_FAILURE = 136; 
STORAGE_CAPACITY_PROBLEM_M3100 = 151; 
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MEMORY_MISI"IATCH = 152; 

CORRUPT_DATA_M3100 = 153; 

OUT_OF_CPU_CYCLES = 154; 

SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

SOFTWARE_DOWNLOAD_FAILURE = 156; 

LOSS_OF_REAL_TIME = 157; 

REINITIALIZED = 158; 

EXCESS IVE_ERROR_RATE = 203; 

ADAPTER_ERROR = 301; 

APPLICATION_SUBSYSTEM_FAILURE = 302; 

BANDWIDTH_REDUCTION = 303; 

C0I^1MUNICATI0N_PR0T0C0L_ERR0R = 305; 

C0I^1MUNICATI0N_SUBSYSTEM_FAILURE = 306; 

CONFIGURATION_OR_CUSTOMIZING_ERROR = 307; 

CONGESTION = 308; 

CPU_CYCLES_LIMIT_EXCEEDED = 310; 

DATA_SET_OR_MODEM_ERROR = 311; 

DTE_DCE_INTERFACE_ERROR = 313; 

EQUIPMENT_MALFUNCTION = 315; 

EXCESSIVE_VIBRATION = 316; 

FILE_ERROR = 317; 

HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM = 321; 

HUMIDITY_UNACCEPTABLE = 322; 

INPUT_OUTPUT_DEVICE_ERROR = 323; 

INPUT_DEVICE_ERROR = 324; 

LAN_ERROR = 325; 

LEAK_DETECTION = 326; 

LOCAL_NODE_TRANSMISSION_ERROR = 327; 

MATERIAL_SUPPLY_EXHAUSTED = 330; 

OUT_OF_MEMORY = 332; 

OUTPUT_DEVICE_ERROR = 333; 

PERFORMANCE_DEGRADED = 334; 

PRESSURE_UNACCEPTABLE = 336; 

QUEUE_SIZE_EXCEEDED = 339; 

RECEIVE_FAILURE = 340; 

REMOTE_NODE_TRANSMISSION_ERROR = 342; 

RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

RESPONSE_TIME_EXCESSIVE = 344; 

RETRANSMISSION_RATE_EXCESSIVE = 345; 

SOFTWARE_ERROR = 34 6; 

SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 347; 

SOFTWARE_PROGRAM_ERROR = 34 8; 

TEMPERATURE_UNACCEPTABLE = 350; 

THRESHOLD_CROSSED = 351; 

TOXIC_LEAK_DETECTED = 353; 

TRANSMIT_FAILURE = 354; 

UNDERLYING_RESOURCE_UNAVAILABLE = 356; 

VERSION_MISMATCH = 357; 

A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

ANTENNA_PROBLEM = 5 03; 

BATTERY_BREAKDOWN = 504; 

BATTERY_CHARGING_FAULT = 505; 

CLOCK_SYNCHRONISATION_PROBLEM = 506; 

COMBINER_PROBLEM = 507; 

DISK_PROBLEM = 50 8; 

EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

EXCESSIVE_TRANSMITTER_OUTPUT_POWER = 511; 

EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

FREQUENCY_HOPPING_DEGRADED = 513; 

FREQUENCY_HOPPING_FAILURE = 514; 

FREQUENCY_REDEFINITION_FAILED = 515; 

LINE_INTERFACE_FAILURE = 516; 

LINK_FAILURE = 517; 

LOSS_OF_SYNCHRONISATION = 518; 

LOST_REDUNDANCY = 519; 

MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 520; 

MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

POWER_SUPPLY_FAILURE = 522; 

RECEIVER_ANTENNA_FAULT = 523; 

RECEIVER_MULTICOUPLER_FAILURE = 525; 

REDUCED_TRANSMITTER_OUTPUT_POWER = 526; 

SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

TIMESLOT_HARDWARE_FAILURE = 528; 

TRANSCEIVER_PROBLEM = 52 9; 

TRANSCODER_PROBLEM = 53 0; 

TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

TRANSMITTER_ANTENNA_FAILURE = 532; 
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TRANSMITTER_ANTENNA_NOT_ADJUSTED = 533; 
TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 
TRANSMITTER_OFF_FREQUENCY = 536; 
DATABASE_INCONSISTENCY = 537; 
FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 
INPUT_PARAMETER_OUT_OF_RANGE = 53 9; 
INVALID_PARAMETER = 540; 
INVALID_POINTER = 541; 
MESSAGE_NOT_EXPECTED = 542; 
MESSAGE_NOT_INITIALISED = 543; 
MESSAGE_OUT_OF_SEQUENCE = 54 4; 
SYSTEM_CALL_UNSUCCESSFUL = 545; 
TIMEOUT_EXPIRED = 54 6; 
VARIABLE_OUT_OF_RANGE = 547; 
WATCH_DOG_TIMER_EXPIRED = 548; 
COOLING_SYSTEM_FAILURE = 549; 
EXTERNAL_EQUIPMENT_FAILURE = 550; 
EXTERNAL_POWER_SUPPLY_FAILURE = 551; 
EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 
REDUCED_ALARM_REPORTING = 561; 
REDUCED_EVENT_REPORTING = 5 62; 
RECUCED_LOGGING_CAP ABILITY = 5 63; 
SYSTEM_RESOURCES_OVERLOAD = 5 64; 
BROADCAST_CHANNEL_FAILURE = 5 65; 
CALL_ESTABLISHMENT_ERROR = 566; 
INVALID_MESSAGE_RECEIVED = 567; 
INVALID_MSU_RECEIVED = 568; 
LAPD_LINK_PROTOCOL_FAILURE = 569; 
LOCAL_ALARM_INDICATION = 570; 
REMOTE_ALARM_INDICATION = 571; 
ROUTING_FAILURE = 572; 
SS7_PR0T0C0L_FAILURE = 573; 
TRANSMISSION_FAILURE = 574; 



/* 

This block identifies the acknowledgement state of a reported alarm. 

*/ 

interface AckState 

{ 

const short ACKNOWLEDGED = 1; 

const short UNACKNOWLEDGED = 2; 



/* 

This block identifies attributes which are included as part of the Alarm IRP 

These attribute values should not clash with those defined for the attributes 

of notification header (see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string 

const string 

const string 

const string 



ALARM_ID = "f"; 
PROBABLE_CAUSE = "g 
PERCE IVED_SEVERITY 
SPECIFIC_PROBLEM = 

const string ADDITIONAL_TEXT = " 

const string ACK_TIME = "k"; 

const string ACK_USER_ID = "1"; 

const string ACK_SYSTEM_ID = "m" 



const string 

const string 

const string 

const string 

const string 

const string 

const string 

const string 

const string 

const string 

const string 



ACK_STATE = "n"; 
COMMENTS = "o"; 
BACKED_UP_STATUS = "p"; 
BACK_UP_OBJECT = "q"; 
THRESHOLD_INFO = "r"; 
TREND_INDICATION = "s"; 
STATE_CHANGE_DEFINITION = 
MONITORED_ATTRIBUTES = "r 
PROPOSED_REPAIR_ACTIONS = 
CORRELATED_NOTIFICATIONS 
REASON = "x"; 



"t"; 



/* 

Defines the content of a Comment 

V 

struct Comment 

{ 

ManagedGenericIRPConstDef s ; ; IRPTime comment_time; 
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string comment_text; 
string user_id; 
string system_id; 

}; 

/* 

Defines a set of comments which are placed in the COMMENTS attribute 

of a structured event. 

V 

typedef sequence <Comment> CommentSet; 

/* 

It indicates if an object has a back up. 

True implies backed up. False implies not backed up, 

*/ 

typedef boolean BackedUpStatusType; 

/* 

It indicates if the threshold crossed was in the up or down direction. 

*/ 

enum ThresholdlndicationType (Up, Down}; 

/* FloatTypeOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise the value is null. 
*/ 

union FloatTypeOpt switch (boolean) 
( 

case TRUE: float value; 

}; 

/* ThresholdLevellndType describes multi-level 
threshold crossings . 

Up is the only permitted choice for a counter. 
If indication is "up", low value is optional. 

@member indication: indicates up or down direction 

of crossing. 
@member low: the low observed value. 
©member high: the high observed value. 

struct ThresholdLevellndType 
{ 

ThresholdlndicationType indication; 

FloatTypeOpt low; 

float high; 

}; 

/* ThresholdLevellndTypeOpt is an optional type. 

If the discriminator is true the value is present. 

Otherwise, the value is null . 
*/ 

union ThresholdLevellndTypeOpt switch (boolean) 
{ 

case TRUE: ThresholdLevellndType value; 



/* Thresholdinf oType indicates some guage or counter 
attribute passed a set threshold. 

©member attributelD: identifies the attribute that 

crossed the threshold, 
©member observedValue : attributes that are of type 

integer will be converted to floats. 
©member thresholdlevel : This parameter is for 

multi-level threhsolds. Optional, 
©member armTime: May contain empty string. 

struct Thresholdinf oType 
{ 

string attributelD; 

float observedValue; 
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ThresholdLevellndTypeOpt thresholdLevel; 
string armTime; 

}; 

/* 

It indicates if some observed condition is getting better, worse, 

or not changing. 

*/ 

enum TrendlndicationType (LessSevere, NoChange, MoreSevere}; 

/* 

It is used to report a changed attribute value. 

*/ 

struct AttributeValueChangeType 

{ 

string attribute_name; 

any old_value; // type depends on attribute 

any new_value; // type depends on attribute 

}; 

typedef sequence <AttributeValueChangeType> AttributeChangeSetType; 

/* 

It is used to report an attribute and its value. 

*/ 

struct AttributeValueType 

{ 

string attribute_name; 

any value; // type depends on the attribute 
}; 

typedef sequence <AttributeValueType> AttributeSetType; 

typedef sequence <long> Notif IdSetType; 

/* 

This holds identifiers of notifications that are correlated. 

*/ 

struct CorelatedNotif ication 

{ 

string source; // Contains DN of MO that emitted the set of notifications 

// DN string format in compliance with Name Convention for 

// Managed Object. 

// This may be a zero-length string. In this case, the MO 

// is identified by the value of the MOI attribute 

// of the Structured Event, i.e. the notification. 
Notif IdSetType notif_id_set; // Set of related notification ids 
}; 

/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

V 

typedef sequence <CorelatedNotif ication> CorrelatedNotif IcationSetType; 

/* 

ShortTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 

union ShortTypeOpt switch (boolean) 

{ 

case TRUE; short value; 

}; 
/* 

Define the structure of Alarm ID and Perceived Severity used within the 

alarm acknowledgment operation. Note; perceived_severity is an optional 

parameter. If this value is present, it must have one of the defined values 

of Interface PerceivedSeverity . 

*/ 

struct Alarmlnf ormationldAndSev 

{ 

string alarm_inf ormation_ref erence; 

ShortTypeOpt perceived_severity; 
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/* 

Define set of the above structure of Alarm ID and Perceived Severity. 

V 

typedef sequence <AlarmInformationIdAndSev> Alarmlnf ormationldAndSevSeq; 

/* 

It indicates the reason for an alarm acknowledgement to have failed: 

- The specified Alarm Information is absent from the Alarm List 

- The Perceived Severity to be acknowledged has changed and/or is different 
within the Alarm List 

- The acknowledgement failed for some other reason 
*/ 

enum AcknowledgeFailureCategories 
{ 

UnknownAlarmId, 

WrongPerceivedSe verity. 

Acknowledgment Failed 
}; 

/* 

Define the structure returned when an operation fails for a set of alarm ids. 

A reason is provided in order to indicate why the operation failed. 

*/ 

struct BadAlarmInf ormationid 

{ 

string alarm_inf ormation_ref erence; 

string reason; 

}; 

/* 

Define the structure returned when the acknowledge operation fails for a set 

of alarm ids . 

A failure category and a reason are provided in order to indicate why the 

operation failed. 

V 

struct BadAcknowledgeAlarmInf o 

{ 

string alarm_information_ref erence; 

AcknowledgeFailureCategories f ailure_category; 

string reason; 
}; 

typedef sequence <BadAlarmInformationId> BadAlarmlnformationldSeq; 

typedef sequence <BadAcknowledgeAlarmInfo> BadAcknowledgeAlarmlnfoSeq; 

typedef sequence <string> AlarmlnformationldSeq; 

typedef CosNotif ication: :EventBatch AlarmlnformationSeq; 
}; 
#endif 
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A.2 IDL specification (file name "AlarmlRPSystem.idl") 

#ifndef AlarmIRPSystem_idl 
#define AlarmIRPSystem_idl 

#include "AlarmlRPConstDef s , idl" 

# include "ManagedGenericIRP System. idl" 

// This statement must appear after all include statements 
#pragma prefix "SgppsaS . org" 

/* ## Module: AlarmlRPSystem 

This module contains the specification of all operations of Alarm IRP Agent. 



mo du 1 e Ala rm I RP System 
{ 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
is outside the scope of this IRP. 

exception GetAlarmlRPVersions ( string reason; }; 
exception GetAlarmlRPOperationsProf lie ( string reason; }; 
exception GetAlarmlRPNotif icationProf lie ( string reason; }; 
exception AcknowledgeAlarms ( string reason; }; 
exception UnacknowledgeAlarms ( string reason; }; 
exception CommentAlarms ( string reason; }; 
exception GetAlarmList ( string reason; }; 
exception GetAlarmCount ( string reason; }; 
exception NextAlarmInf ormations { string reason; }; 

/* 

The Alarmlnf ormationlterator is used to iterate through a snapshot of 
Alarm Informations taken from the Alarm List when IRPManager invokes 
get_alarm_list . IRPManager uses it to pace the return of Alarm 
Informations . 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface Alarmlnf ormationlterator 

( 

This method returns between 1 and "how_many" Alarm Informations. The 
IRPAgent may return less than "how_many" items even if there are more 
items to return. "how_many" must be non-zero. Return TRUE if there may 
be more Alarm Information to return. Return FALSE if there are no more 
Alarm Information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 

iterator. 

boolean next_alarmlnf ormations ( 

in unsigned short how_many, 

out AlarmlRPConstDef s : : Alarmlnf ormationSeq alarm_inf ormations 
) 
raises (NextAlarmInf ormations, ManagedGenericIRPSystem: : InvalidParameter) ; 



This method destroys the iterator. 
void destroy (); 



interface Alarm IRP 
( 

Return the list of all supported Alarm IRP versions. 

Implementations are to provide a return value consisting of one or more IRPVersions. 

Each IRPVersion is defined by the rule in the clause titled 

"IRP document version number string" 
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ManagedGenericIRPConstDef s : : VersionNumberSet get_alarm_IRP_versions ( 

) 

raises (GetAlarmlRPVersions ) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific Alarm IRP version. 

*/ 

ManagedGenericIRPConstDef s ; ;MethodList get_alarm_IRP_operations„prof ile ( 

in ManagedGenericIRPConstDef s ; ;VersionNumber alarm_irp_version 
) 
raises (GetAlarmlRPOperationsProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem; ; InvalidParameter ) ; 

/* 

Return the list of all supported notifications and their supported 
parameters for a specific Alarm IRP version. 
V 

ManagedGenericIRPConstDef s : :MethodList get_alarm_IRP_notif ication_prof ile 
( 

in ManagedGenericIRPConstDef s ; :VersionNumber alarm__irp_version 
) 
raises (GetAlarmlRPNotif icationProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem; ; InvalidParameter) ; 

Request to acknowledge one or more alarms. 

ManagedGenericIRPConstDef s : : Signal acknowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldAndSevSeq alarm_inf ormation_id_and_sev_list, 
in string ack_user_id, 
in string ack_system_id, 

out AlarmlRPConstDef s : : BadAcknowledgeAlarmInf oSeq 
b a d__a c k_a 1 a rm_i n f o_l i s t 
) 

raises (Ac knowledge Alarms, ManagedGenericIRPSystem: : ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to remove acknowledgement information of one or more alarms. 

ManagedGenericIRPConstDef s : : Signal unacknowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list, 
in string ack_user_id, 
in string ack_system_id, 

out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 
raises ( Una c knowledge Alarms, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : Par ameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Make comment to one or more alarms. 

ManagedGenericIRPConstDef s : : Signal comment_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string comment_user__id, 
in string comment_system_id, 
in string comment_text , 

out AlarmlRPConstDef s : : BadAlarmInf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises (Comment Alarms, ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 

in Alarmlnf ormationSeq that contains or more Alarm Informations. 
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Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in Alarmlnf ormationSeq. 

IRPAgent needs to use iter to retrieve them. 

V 

AlarmlRPConstDef s : : Alarmlnf ormationSeq get_alarm_list ( 

in string filter, 

out boolean flag, 

out Alarmlnf ormationlterator iter 
) 

raises (GetAlarmList , ManagedGenericIRP System: : ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

This method returns the count of Alarm Informations. 

*/ 

void get_alarm_count ( 

in string filter, 

out unsigned long critical_count , 

out unsigned long major_count, 

out unsigned long minor_count, 

out unsigned long warning_count, 

out unsigned long indeterminate_count, 

out unsigned long cleared_count 
) 

raises (GetAlarmCount, ManagedGenericIRPSystem: ;OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif 
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